GETHOSTNAME

Section: C Library Functions (3)
Index Return to Main Contents

BSD mandoc
BSD 4.2

NAME

gethostname sethostname - get/set name of current host

SYNOPSIS

Fd #include <unistd.h> Ft int Fn gethostname char *name int namelen Ft int Fn sethostname const char *name int namelen

DESCRIPTION

Fn Gethostname returns the standard host name for the current processor, as previously set by Fn sethostname . The parameter Fa namelen specifies the size of the Fa name array. The returned name is null-terminated unless insufficient space is provided.

Fn Sethostname sets the name of the host machine to be Fa name , which has length Fa namelen . This call is restricted to the super-user and is normally used only when the system is bootstrapped.

RETURN VALUES

If the call succeeds a value of 0 is returned. If the call fails, a value of -1 is returned and an error code is placed in the global location errno

ERRORS

The following errors may be returned by these calls:

Bq Er EFAULT: The Fa name or Fa namelen parameter gave an invalid address.
Bq Er EPERM: The caller tried to set the hostname and was not the super-user.

BUGS

Host names are limited to MAXHOSTNAMELEN (from Ao Pa sys/param.h Ac ) characters, currently 256.

HISTORY

The function call appeared in BSD 4.2

This document was created by man2html, using the manual pages.
Time: 16:28:58 GMT, April 18, 2022